Skip to content

Document Tag removal confirmation and expandable Tags tile on Contact detail page#779

Open
promptless-for-oss wants to merge 3 commits into
mautic:7.2from
Promptless:promptless/tag-removal-confirmation-7.2
Open

Document Tag removal confirmation and expandable Tags tile on Contact detail page#779
promptless-for-oss wants to merge 3 commits into
mautic:7.2from
Promptless:promptless/tag-removal-confirmation-7.2

Conversation

@promptless-for-oss

Copy link
Copy Markdown
Contributor

Open this suggestion in Promptless to view citations and reasoning process

Adds a "Viewing and removing Tags on a Contact" section to tags.rst describing the new confirmation dialog when removing a Tag from the Contact detail page, and the expandable Tags tile that shows the first 8 Tags when a Contact has more than 8. Based on merged mautic/mautic PR #15845. Targets the 7.2 user docs branch (PR base 7.x).

Trigger Events


Tip: Sort by Shortest Review in the Dashboard to find quick wins ⚡

Comment thread docs/contacts/tags.rst

A Contact's Tags appear on the Contact's detail page in a dedicated Tags tile. If a Contact has 8 or fewer Tags, the tile shows all of them. If a Contact has more than 8, the tile shows the first 8 and becomes expandable - use the control on the tile to view the remaining Tags.

To remove a Tag from the Contact's detail page, click the **x** icon on the Tag. Mautic displays a confirmation dialog asking 'Are you sure you want to remove this tag from the contact?'. Click **Confirm** to remove the Tag, or **Cancel** to keep it. This confirmation step prevents you from accidentally removing a Tag with a single click.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The exact confirmation message 'Are you sure you want to remove this tag from the contact?' comes from the new mautic.lead.tag.confirm_remove string added in app/bundles/LeadBundle/Translations/en_US/javascript.ini, and the Mautic.removeTagFromLead/confirmRemoveTagFromLead changes in lead.js introduce the Confirm/Cancel dialog before removing a Tag.

Source: mautic/mautic#15845

Comment thread docs/contacts/tags.rst

.. vale on

A Contact's Tags appear on the Contact's detail page in a dedicated Tags tile. If a Contact has 8 or fewer Tags, the tile shows all of them. If a Contact has more than 8, the tile shows the first 8 and becomes expandable - use the control on the tile to view the remaining Tags.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The 8-Tag threshold and expandable tile behavior come from lead.html.twig, where maxVisibleTagsCount = 8 selects a tile--base for 8 or fewer Tags and a tile--expandable-interactive (first 8 above the fold, remainder below) when tagCount > maxVisibleTagsCount.

Source: mautic/mautic#15845

Comment thread docs/contacts/tags.rst
@adiati98 adiati98 requested a review from escopecz July 15, 2026 04:56
…f/on

Per @adiati98 review on PR mautic#779, the section heading is now Vale-checked
normally and the two body paragraphs are wrapped in .. vale off / .. vale on.
Comment thread docs/contacts/tags.rst
Per @adiati98's follow-up review on PR mautic#779, the 'Viewing and removing
Tags on a Contact' heading is now wrapped in its own .. vale off /
.. vale on block, and the body paragraphs remain in a separate block.
Vale passes clean.
@promptless-for-oss

Copy link
Copy Markdown
Contributor Author

Thanks @adiati98 — both review comments are addressed and the branch has been updated.

The Vale markup on the "Viewing and removing Tags on a Contact" section is now restructured so it's consistent with the rest of the file:

  • The section heading is wrapped in its own .. vale off / .. vale on block.
  • The two body paragraphs (the Tags tile / expandable behavior and the Tag removal confirmation dialog) are wrapped in a separate .. vale off / .. vale on block.

Vale now runs clean on docs/contacts/tags.rst (0 errors, 0 warnings, 0 suggestions) — including the earlier Google.Headings sentence-case warning, which the heading wrapper resolves.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants